{{tag>Natty tutoriel clavier BROUILLON}}
----

<note warning>Page en élaboration</note>

====== Exemple de création d'un agencement de clavier personnalisé ======
Cette page illustre par un exemple concret et complet, la mise en place d'un agencement personnalisé disponible ensuite dans l'interface graphique au même titre que ceux fournis avec la distribution.

Il s'agit avant tout de la description **détaillée** des raisonnements suivis et de l'utilisation des outils disponibles pour faciliter ce travail. Néanmoins, pour faciliter la vision d'ensemble, les grande ligne de la méthodes sont présentées sur la page [[tutoriel:creer_et_utiliser_un_agencement_de_clavier_personnalise|Créer et utiliser un agencement de clavier personnalisé]].

La lecture de cette page suppose compris les concepts généraux présentés sur la page [[tutoriel:comprendre_la_configuration_du_clavier|Comprendre la configuration du clavier]].

===== Description de l'objectif =====
L'objectif est de :
  - disposer d'un agencement personnalisé basé sur le clavier bépo français de marque Typematrix,
  - compléter, voire ré-organiser, la distribution des symboles sur les touches.
  - en particulier, créer des niveaux supplémentaires pour ajouter à certaines touches les symboles monétaires de certaines devises et quelques symboles mathématiques.
  - utiliser la touche Alt de gauche pour accéder aux niveaux au delà de quatre.

===== Prise de connaissance avec la configuration actuelle =====

==== Manipulation préliminaires ====
Pour éviter toute interférence nuisible à la perception de la situation de base, on ne conserve qu'un seul agencement, en l'occurrence, celui qui nous sert de base.
Pour cela, nous utilisons le dialogue des préférences du clavier accessible par Système -> Préférence -> Clavier.

Ensuite, par le bouton des options présent dans ce dialogue, nous supprimons toutes les options, en les notant si besoin, qui s'écartent de la configuration par défaut. 

==== Connaître avec le clavier ====
Ouvrez un [[:terminal]] et entrez la [[:commande_shell|commande]] suivante :
<code>xkbprint -label name $DISPLAY - | gv -orientation=seascape -</code>
Une image du clavier portant les noms symboliques des touches et le code de ces touches., apparaît. Nous devrons nous y référer chaque fois qu'il nous sera nécessaire d'identifier précisément une touche.
<note important>Attention cependant, la description de ce clavier fait intervenir des fichiers descriptifs indépendants du fonctionnement du clavier. Il arrive que ces fichiers soient erronés sans que cela ait le moindre retentissement sur le fonctionnement, ce qui ne facilite pas la mise en évidence des erreurs. Pour garantir les informations sur la touche, il faut faire appel à l'utilitaire **xev**</note>

Ouvrez un [[:terminal]] et entrez la [[:commande_shell|commande]] suivante :
<code>xev</code>
Une fenêtre de terminal s'ouvre ainsi qu'une fenêtre plus petite intitulée //Event tester//.
Frappez sur une touche (k par exemple). Dans la fenêtre du terminal, un grand nombre d'informations sur les différents évènements générés s'affichent. Nous y trouvons en particulier les lignes suivantes :

>KeyRelease event, serial 37, synthetic NO, window 0x4c00001,
>    root 0x15a, subw 0x0, time 50238474, (229,1101), root:(230,1128),
>   state 0x10, **keycode 56 (keysym 0x6b, k)**, same_screen YES,
>   XLookupString gives 1 bytes: (6b) "k"
>    XFilterEvent returns: False

La partie qui nous intéresse ici est en gras. Elle devrait confirmer les informations de l'image précédente, à savoir que le code de la touche marquée «k» est 56 et que le symbole de touche associé est k ((à condition de ne pas appuyer sur ⇧en même temps. 

==== Connaître les fichiers de configuration actifs ====
Dans un [[:terminal]], entrez la [[:commande_shell|commande]] suivante :
<code>setxkbmap -print</code>

>jaaf@jaaf-P55A-UD4:~$ setxkbmap -print
>xkb_keymap {
>	xkb_keycodes  { include "evdev+aliases(azerty)"	};
>	xkb_types     { include "complete"	};
>	xkb_compat    { include "complete"	};
>	xkb_symbols   { include "pc+fr(bepo)+inet(evdev)+terminate(ctrl_alt_bksp)"	};
>	xkb_geometry  { include "typematrix(tm2030USB)"	};
>};
>jaaf@jaaf-P55A-UD4:~$ 
 
=== Les options ===

Avant de nous intéresser aux autres fichiers de configuration, arrêtons nous un instant sur la fin de la ligne qui 
commence par xkb_symbols, c'est à dire : +terminate(ctrl_alt_bksp).

Cet expression représente la traduction en terme de configuration de l'option (que nous n'avons pas supprimée) définissant le choix de la commande à utiliser pour arrêter le serveur X.

Si nous explorons le dossier /usr/share/X11/xkb/symbols où sont censés se trouver les fichiers de définitions des symboles associés aux touches, nous y trouvons let fichier terminate dont le contenu est le suivant :
partial default modifier_keys

>xkb_symbols "ctrl_alt_bksp" {
>   key <BKSP> {
>        type="CTRL+ALT",
>        symbols[Group1] = [ NoSymbol,       ** Terminate_Server** ]
>   };
>};

Nous voyons que le symbole de terminaison du serveur, Terminate_Server, en gras ici, est associé à la touche <BKSP> qui possède deux niveaux et dont l'accès au deuxième niveau est donné par la combinaison de touches Ctrl + Alt comme le décrit l'extrait suivant du fichier  /usr/share/X11/xkb/types/pc  :
>   ** type "CTRL+ALT"** {
>	modifiers = Control+Alt;
>	map[Control+Alt] = Level2;
>	level_name[Level1] = "Base";
>	**level_name[Level2] = "Ctrl+Alt";**
>    };

Nous notons au passage que l'option, introduite par un signe **+**, s'ajoute, selon les règles de fusion citées à la section [[tutoriel:comprendre_la_configuration_du_clavier|Comprendre la configuration du clavier#Mise en œuvre des modes de fusion]], en mode //override//, c'est à dire, qu'elle prend l'avantage sur toute déclaration antérieure. 

<note>Notons également qu'il en va de même pour toutes les options qui ont pour ainsi dire le dernier mot.</note>

=== Les fichiers de symboles ===

Reprenons la ligne qui parle des symboles dans la sortie de la commande //setxkbmap -print// :

> xkb_symbols   { include "pc+fr(bepo)+inet(evdev)+terminate(ctrl_alt_bksp)"	};

Mis à part les options qui viennent se surajouter, nous lisons que l'affectation des symboles de touche aux touches, se fait par les définitions du  fichier **pc** auxquelles viennent se surajouter, en mode //override//  (signe +), celles de la section **bépo** du fichier **fr**, puis celles de la section **evdev** du fichier **inet**. Tous ces fichiers étant bien-sûr ceux du dossier usr/share/X11/xkb/symbols.


>default partial modifier_keys
>xkb_symbols "ralt_switch" {
> key <RALT> {
>    type[Group1]="ONE_LEVEL",
>    symbols[Group1] = [ ISO_Level3_Shift ]
>    };
>  modifier_map Mod5   { ISO_Level3_Shift };
>};
